home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 12 C64 Telecom / TERMX1.SDA / TERMX1.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  4.1 KB  |  89 lines
  1.  
  2. ********************************************************************************
  3.                                TERM.X1
  4. ********************************************************************************
  5.  A Machine Language XMODEM subroutine for use with BASIC terminal and BBS
  6. programs.
  7.  TERM.X1 (c) (TM) 1985 by Chrisdos. All rights reserved.
  8.   TERM.X1 may be included in your BBS or Terminal program if proper credit
  9. is given Chrisdos in the program. This subroutine may not be sold or placed
  10. in a program that is being sold.
  11. This program may not be uploaded to any other SIG or BBS without the
  12. express permission of Chrisdos. [76703,717]
  13. TERM.X1 will be maintained by the Sysop of the Compuserve CB Interest Group SIG
  14. (CBIG) and the program may be found in the database of that sig.
  15. --------------------------------------------------------------------------------
  16.  
  17.         Term.x1 is a Machine Language program that may be used as a subroutine
  18. by a basic program to allow the basic program to do fast XMODEM file
  19. transfers. The XMODEM file transfer routines are modified versions taken
  20. from the CBterm/C64 terminal program. Also included in term.x1 is a little
  21. terminal emulater subroutine that is capable of running at 1200 baud.
  22.  The Xmodem routines can run either at 300 or 1200 baud, but if you impliment
  23. your terminal emulater in BASIC, BASIC can only keep up at 300 baud.
  24.  
  25. Term.x1 is ideal for inclusion in a terminal program or BBS system. With
  26. a simple set up and call to term.x1 you can impliment full XMODEM file
  27. transfer.
  28.  
  29. Term.x1 loads into hi memory of the C64 and takes no space from BASIC, it
  30. loads in the $C000 to $C7FF range. This includes all room for buffersy and
  31. pointers. The only other memory used is 6 bytes in page 0 memory that are
  32. the floating point acumulator in basic. There is no conflict since
  33. BASIC is off while term.x1 is in control.
  34.  (Other load address for term.x1 may be obtained by contacting Chrisdos by
  35. a message to SYSOP in CBIG.)
  36.  
  37. Term.x1 contains 3 subroutines: DOWNLOAD, UPLOAD, and TERMINAL. You may use
  38. any one or all in your program.
  39.  
  40. Operation
  41. ---------
  42. First, you have your BASIC program load term.x1 into memory so it can be
  43. called via the SYS function when needed.
  44. Term.x1 expects to be able to find the RS232 opened as logcal device 5
  45. and the disk as logical device 8.
  46.  
  47. DOWNLOADING
  48. -----------
  49. Before calling term.x1 to download you must have the disk file opened
  50. in the name you wish to save the incomming data as.
  51.  
  52. You have the sending computer go into its download mode, and you SYS 49152.
  53. Term.x1 will then handshake and do a XMODEM download.
  54. The subroutine may be aborted by pressing the Commodore key C= and CTRL
  55. together.
  56. The routine will return with a 0 in location 780 if the download was OK
  57. or a 255 in location 780 if it failed or aborted.
  58.  
  59. UPLOADING
  60. ---------
  61. To upload, you open the file you wish to send, have the recieveing computer
  62. start looking for the XMODEM upload and then SYS 49155.
  63. Term.x1 will then upload the file and return with a 0 in 780 if
  64. all was ok or 255 if it failed or aborted. The Upload can be aborted
  65. by pressing C= CTRL.
  66.  
  67. TERMINAL
  68. --------
  69. Because BASIC cannot keep up with 1200 baud speed, a little terminal subroutine
  70. was added to term.x1. If you SYS49158 you will send out the modem
  71. ASCII data as typed on the keyboard and display recieved ASCII data.
  72. (in other words, the subroutine translates petscii/ascii)
  73. To exit terminal mode press C= CTRL.
  74.  
  75. --------------------------------------------------------------------------------
  76. Term.x1 does no disk error checking. This is left to you and your basic
  77. program. Before doing a upload, you had better make sure the disk file
  78. you want is propperly opened. The same for a download, you had better have
  79. room on the disk for the file.
  80.  
  81. See the sample program BASX1 for a view as to how to use TERM.X1.
  82.  
  83. Any comments or suggestions may be left in a message to SYSOP in the
  84. CBIG Sig. No Email please.
  85. ********************************************************************************
  86. For background information, see the files on the CBterm/C64 program, as these
  87. routines are a subset of that program.
  88.   -Chrisdos
  89.